home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / MUSIC / @FALCON / MGPL-115 / DOCS / MGPL-ENG.TXT < prev    next >
Encoding:
Text File  |  1995-10-22  |  18.0 KB  |  486 lines
  1.  
  2. ----------------------------------------------------
  3. MegaPlayer┐ Version 1.15, the 15th of October 1995
  4.  By Stéphane LESAGE aka Simplet / FATAL DESIGN
  5.  e-mail 100620,2673@compuserve.com (Skynet/FD)
  6. ----------------------------------------------------
  7.  
  8. It is strictly forbidden to modify this program or use of some parts of it
  9. without my agreement. The Replay Routines, are freeware and you can freely use
  10. them in any public domain program to the condition that you mention where they
  11. come from. It is forbidden to use them in a commercial product. Contact me if
  12. you need them for such a project.
  13.  
  14. You don't have to remove files from the archive.
  15. You must transmit it completely and gratis. Some PD organisms can take
  16. copying fees and only for copying, as long as no benefit is made.
  17.  
  18. I authorise magazines to put this program on their cover disk to only condition
  19. that they send me the corresponding number, which is not too much ask.
  20.  
  21.  
  22. Shareware :
  23. -----------
  24.  
  25. The MegaPlayer has now become a shareware program !
  26.  
  27. If you regularly use the MegaPlayer, you must send a modest contribution
  28. You will then receive a registered version to your name and will benefit of
  29. all the advantages it has on the unregistered release.
  30.  
  31. Try to make an effort, take an envelop, stamps, a 50FF, 15DM, £5 or 10$ cheque
  32. or a 50FF bank-note and send it to me.
  33.  
  34. The last updates of this program will be found on ftp.cnam.fr
  35. But keep in mind that there will not be many updates before June 1996
  36. because I must continue my studies and prepare for exams.
  37. So get registered if you want to have a good version of the MegaPlayer.
  38. You won't regret it. And think a little about me who works for more than
  39. one year on this program !
  40.  
  41.  
  42. Little Doc
  43. ----------
  44.  
  45. The MegaPlayer┐ lets you listen SoundTracker music modules composed with
  46. digitalised instruments. It has a GEM interface and can run as an accessory
  47. (rename it MGT-PLAY.ACC et place it in C:\ with the resource file)
  48. It uses the DSP to procedure an 16 bits stereo sound at 49KHz withtout
  49. slowing down your machine.
  50. It supports several different formats with any number of voices :
  51.     - .MOD    SoundTracker,ProTracker,NoiseTracker,StarTrekker (Amiga)
  52.             Octalyser (ST-Falcon), FastTracker I (PC)
  53.     - .669    Composer 669 (PC)
  54.     - .OKT    Oktalyzer (Amiga)
  55.     - .MTM    MultiTracker (PC)
  56.     - .S3M    ScreamTracker 3.0 to 3.2 (PC)
  57.     - .ULT    UltraTracker 1.4 to 1.6 (GUS on PC)  (Registered version only)
  58.     - .DTM    Digital Tracker 2.04 (Falcon)        (Registered version only)
  59.     - .XM    FastTracker II (PC)                  (Registered version only)
  60. You can pack your modules with the following packers :
  61. Atomik 3.5, Ice 2.4, SpeedPacker 3, Sentry 2.0
  62. or PowerPacker 2.0 (Amiga)
  63. Please don't use the NoisePacker, it DESTROYS your module by coding the
  64. samples on 4 bits !!!
  65.  
  66. The MegaPlayer┐ is very simple to use. Its interface is that of a CD player.
  67. Here is the detail for some options :
  68.  
  69. - click on the module name makes display the samples names every second.
  70. click once again to stop it.
  71.  
  72. - 'Rep' is used to select the automatic restart mode of a module.
  73. It should be disabled in order to cope with the List mode.
  74.  
  75. - 'Inf' shows you some information on the currently loaded module.
  76.  
  77. - 'Osc' displays the Oscilloscops window.
  78.  
  79. - 'SpA' displays the Spectrum Analyser window.
  80. This option is not implemented in the unregistered version.
  81.  
  82. - 'Snd' allows you to access the Sound Control Window, to change the replay
  83. frequency or several volume parameters.
  84.  
  85. - 'Cfg' is used to change so configuration parameters.
  86.  
  87. - 'List' allows you to access to the Modules List functions of the MegaPlayer┐.
  88. In a way, they are equivalent to the programmation of a CD player.
  89. When a module is finished, the MegaPlayer┐ plays the next one in the List.
  90. (if the 'Rep' option is not enabled !)
  91. Use the 'Add' option to add a module after the end of the list, or click on a
  92. module and then use 'Insert' to insert a module just before the one you have
  93. selected.
  94. Use 'Remove' to remove the selected module from the list.
  95. You can 'Save' this list to 'Load' it after or to play it automatically on
  96. the accessory boot, just rename it MGT-PLAY.MPL and place it in C:\.
  97. You can use the 'Merge' option to add a whole list to the current list.
  98. Of course, the 'Clear' option clears the whole list.
  99.  
  100. When selecting modules, you can use wildcards (? and *) to specify a set of
  101. files.
  102. You can also select several modules if you use the Selectric┐ fileselector.
  103.  
  104. The MegaPlayer┐ (as program) automatically loads the modules or list passed
  105. into the command line. This means you can install it as an GEM application
  106. with parameters (.GTP) for the *.MOD, *.S3M, *.ULT..etc files.
  107.  
  108. The MegaPlayer┐ includes the drag'n'drop protocol, which means that under
  109. MultiTos, you can drag GEM desktop icons for example, on the MegaPlayer┐
  110. windows. If you drag one file on the main window, the module will be loaded
  111. and played. If there are several files or if the only file is a list, then
  112. all the modules will be aded to the list (List Window) or a new list will
  113. be created and played (All other windows).
  114. Available only in the registered version.
  115.  
  116. The MegaPlayer┐ includes the AV-protocol too. It is used by alternative
  117. desktops like Thing,Ease or Gemini. It provides Drag'n'Drop without Multitos
  118. and run-time command lines to be passed to currently running programs.
  119. For example, if you install the MegaPlayer┐ as application for *.MOD files,
  120. double-clicking on a module will load and play it without loading the player
  121. once again if it is already in memory.
  122. Available only in the registered version.
  123. Another feature is to cycle ALL windows with the Control-W key.
  124.  
  125. The MegaPlayer┐ uses a special system to match to your language.
  126. Dependently of the system language (set-up with the NVRAM by default or by
  127. the new AES), it looks for the following Resource files :
  128. MGPL-ENG, MGPL-FRA, MGPL-DEU, MGPL-ESP, MGPL-ITA, MGPL-SWE
  129. I made the French & english Resource files. You can translate yourselft
  130. a Resource file (Warning, don't modify the file's structure) and send it to me.
  131. Antonio Lillo made the Spanish translation. Do like him. Don't forget this
  132. little .TXT documention file.
  133. I wait especially a german translation because there is a lot a Atari
  134. computers there. (Mein Deutch ist nicht sehr gut..)
  135.  
  136.  
  137. So, that's all for the MegaPlayer. Have fun with it !
  138.  
  139.  
  140. GEM Interface on ATARI :
  141. ------------------------
  142.  
  143. I recommend you to use the Thing alternative desktop and Freedom fileselector.
  144. Your machine takes really another dimension with these two programs.
  145. Don't hesitate if you want to improove the comfort of your system. Alternative
  146. desktops don't take a lot of memory because they can be removed from memory
  147. before starting a program. As for Freedom, try it, it's really 
  148.  
  149. I recommend you to use the AES 4.1 too, you will have several advantages
  150. with many applications, and in particular, the MegaPlayer (Inconified Oscillos
  151. and Spectrum are really great !)
  152. You just need to take the GEM.SYS file in your MULTITOS folder or in the
  153. root directory, rename it GEM.PRG or AES41.PRG for example, and place it
  154. at the of your AUTO folder (it must be the last executed program). The only
  155. drawback is that it takes some memory.
  156. You can also use the freeware program Winx.
  157.  
  158.  
  159. Programmers :
  160. -------------
  161.  
  162. You can use the MegaPlayer in you own GEM applications.
  163. To detect its presence, just search the MGT-PLAY or MGPL-REG application with
  164. Appl_Find. Then use the VA_START protocol with as line command, the name(s)
  165. of the module(s) or the list to play. Specify the whole path.
  166.  
  167. I recommend you to recognize the AV Protocol in your applications each time
  168. it is possible. It improoves really the conviviality of the system. You will
  169. find a description of this protocol in the helps of ST-GUIDE and THING or
  170. in the file VA-PROTO.H of Gemini.
  171.  
  172.  
  173. History of the MegaPlayer┐ :
  174. ----------------------------
  175.  
  176. * First version -  beginning of June 1994
  177.  
  178.     Only runs as a program.
  179.     Load only MegaTracker┐ modules !
  180.     and plays them immediatly after loading..
  181.     no checking of sound system use.
  182.     no other words : a big shit !
  183.  
  184. * v0.93₧ --> 06/11/1994
  185.  
  186.     Load module of all formats but not packed.
  187.     Function keys are active
  188.     and the player runs as an accessory
  189.     100% bug free version !
  190.  
  191. * v0.94₧ --> 06/14/1994
  192.  
  193.     Modules conversion improved (conversion in memory and not from disk)
  194.     allowing packed modules loading (but maybe some bugs with big ones)
  195.     Atomik 3.5, Ice 2.4, SpeedPacker 3 & PowerPacker 2.0 depacking.
  196.     Funk Repeat effect implemented
  197.  
  198. * v0.95₧ --> 06/21/1994
  199.  
  200.     Interface improved and modules list implementation.
  201.     Bug fixing and improving of my GEM routs.
  202.  
  203. * v0.95₧ --> 07/11/1994
  204.  
  205.     Parasite noises are attenuated, but there are still some noises.
  206.     Big Bug Fixed. Automatic Playback after loading.
  207.     Keyclick is re-installed after playing.
  208.     S3M format is no more available because pattern data depack takes
  209.     too much memory and it bugs.
  210.  
  211. * v0.96₧ - 07/31/1994 - 9H PM to 9H10 PM
  212.  
  213.     The Strange bug which arrived on some falcons is removed.
  214.     Automatic loading of the modules list MGT-PLAY.MPL on the boot.
  215.  
  216. * v0.96₧ - I don't remember when !
  217.  
  218.     When the DSP doesn't respond, it's not to you to restart the replay
  219.     with Pause & PlayBack becoz there is no more sound, the Player does
  220.     it automatically for you !
  221.  
  222. * v0.96₧ - 08/31/1994 - 9H10 PM to 9H20 PM
  223.  
  224.     669 Modules Tempo corrected.
  225.     It is now fixed to 30 Hz, which seems to be good.
  226.     Bug Report by STORM.
  227.  
  228. * v0.96ß - 09/03/1994 - 5H PM to 6H PM
  229.  
  230.     Command 8 is now implemented as Fine Panning as some Trackers on PC
  231.     use it like this and not as Phasor Effect.
  232.  
  233. * v0.96ß - 10/23/1994 - 0H07 AM to 0H08 AM
  234.  
  235.     669 Modules Tempo now fixed to 32 Hz ( CIA Tempo 80 ), according to BLISS.
  236.  
  237. * v0.97ß - 10/26/1994 --> 10/27/1994
  238.  
  239.     S3M format is now loaded again, the bugs responsible for the
  240.     problems during conversion have been supressed.
  241.     All effects are implemented but Tremor and Retrig+Volume Slide.
  242.  
  243.     Base Frequency of 669 Module fixed to 8740 Hz (according to BLISS)
  244.  
  245. * v0.97ß - 10/28/1994 --> 10/29/1994
  246.  
  247.     New management of resource files.
  248.     New Replay Rout which takes less DSP memory & workspace 030 memory
  249.     releasing 50Kb.
  250.  
  251. * v0.97ß - 10/31/1994 - 1H10 PM to 1H45 PM
  252.  
  253.     Shitty Bug Extermination for low tempos modules.
  254.  
  255. * v0.97ß - 11/12/1994 - 2H PM to 3H10 PM
  256.  
  257.     Timer Event was fixed to 1 sec but is now fixed to 1/100 sec because
  258.     it doesn't slow down the system and because it allows Next Module
  259.     of the List to be loaded fastly or DSP-Prog to be loaded again
  260.     immediately if it has bugged.
  261.  
  262.     Implementation of 669 Format Effects.
  263.  
  264.     New Big Bug not detected.
  265.  
  266. * v0.98ß - 12/26/1994 - 9H55 PM
  267.  
  268.     I have removed THE bug...(a6)+ was replaced by (a0)+ in the effects
  269.     conversion and it shifted pattern data having for consequences
  270.     beautiful crashes...I hate bugs like that, but I must stay cool...
  271.  
  272. * v1.0ß - 04/18/1995 --> 04/22/1995 not Spreaded
  273.  
  274.     New MGT v1.0 format used internaly...
  275.     Replay routines & converter spreaded...
  276.     AES 4.0 friendly interface !
  277.     - Botommed windows
  278.     - Iconification
  279.     - Resolution Change under Multitos with automatic save
  280.       of the windows configuration.
  281.     No more memory limit for the modules size.
  282.     Only loads .MOD modules.
  283.  
  284. * - 06/03/1995 --> 06/11/1995
  285.  
  286.     MGT v1.0 format a bit modified.
  287.     Module List is now avaiblable without the bug it has, I hope.
  288.     Its size is limited to 20Ko rather than 500 Modules
  289.     Loading of modules or list passed by the command line.
  290.     Loading of several modules in the list if the specified file
  291.     contains wildcards (? or *) or if you use the fabulous Selectric┐
  292.     Fileselector.
  293.     Drag'n'Drop protocol under Multitos implemented.
  294.  
  295. * - 08/08/1995 - 3H PM to 3H30 PM
  296.  
  297.     When you click on the module name, the player now displays the
  298.     names of the samples each second.
  299.  
  300. * v1.0 - 08/11/1995 to 08/17/1995
  301.  
  302.     Conversion of MTM and S3M modules implemented.
  303.     Optimisation of the number of tracks by removing the same ones.
  304.     Conversion of ULT modules implemented (not very great)
  305.     Improving of the S3M conversion by playing the 2 specifics effects :
  306.     Tremor and Note Retrig+Volume Slide and with the 2 new effects
  307.     of the ScreamTracker 3.2 : Fine Vibrato & Panning
  308.     New Oktalyzer-style effects Arpeggio 3,4,5 and (Fine) Note Slide.
  309.     Conversion of 669, OKT implemented. XM too, but very strange.
  310.     The replay routine can play samples of any type:
  311.     8 bits Mono, 8 bits Stereo, 16 bits Mono and 16 bits Stereo.
  312.     Conversion of DTM modules implemented.
  313.     Automatic Detection of old 15 samples modules & 8 voices .WOW
  314.  
  315.     First Freeware version Release on ftp.cnam.fr :
  316.     Module list size limited to 1Ko
  317.     The Total size of a module in memory is limited to 350Ko
  318.     No Drag'n'Drop under multitos.
  319.     Loads only .MOD, .669,.MTM and .S3M modules.
  320.  
  321. * v1.03 - 08/19/1995 - not spreaded
  322.  
  323.     The OKT conversion which didn't work anymore due to a cut-paste
  324.     instead of a copy-paste bloc operation has be made again.
  325.     Correction of the XM conversion which was totally bugged.
  326.     Better modules size limitation without bugs (freeware)
  327.  
  328. * v1.05 - 08/20/1995
  329.  
  330.     Implementation of the Oscilloscops.
  331.     Under Aes >=4.0, the MegaPlayer ask to the desktop to update its
  332.     windows when the list is saved.
  333.     Conversion of Initial Global Volume for S3M modules.
  334.     Now 100% compatible to S3M format.
  335.  
  336.     First shareware release.
  337.  
  338. * v1.1 - 08/25/1995
  339.  
  340.     The bug of the 'Add' button when you have no replacement fileselector
  341.     has been exterminated.
  342.     Improoving of replay-routines.
  343.     Sound control and configuration windows.
  344.  
  345. * - 08/26/1995
  346.  
  347.     Implementation of the Spectrum Analyzer (2*16 bands)
  348.     (For registered people only..)
  349.  
  350. * - 08/27/1995
  351.  
  352.     GEM interface improved for interactivity with non on-top windows.
  353.     Just click on the buttons you which to active, you needn't click twice
  354.     to activate the window first and then accomplish the action.
  355.  
  356.     Do you remember the Mouse and Keyboard bugs with strong modules ?
  357.     I have removed this interrupt problem.
  358.  
  359.     The spectrum Analyzer displays now 2*32 bands because 2*16 wasn't
  360.     enough. It runs always at 50 frames per second with NVDI in 2,4
  361.     or 16 colors.
  362.  
  363. * - 08/28/1995
  364.  
  365.     The Command Line now accepts the wildcards (* and ?)
  366.     The 'Add' and 'Insert' functions are debugged.
  367.  
  368. * v1.11 - 08/31/1995
  369.  
  370.     The Bug of the Tremolo effect conversion is removed.
  371.  
  372. * v1.12 - 09/03/1995
  373.  
  374.     The panoramics for Amiga and 669 modules are now $c040 and $40c0
  375.     for Left and Right (like the S3M modules), it is a lot better than
  376.     mono $ff00 and $00ff panoramics, especially for headphones.
  377.     Only in Mod-Conv and Registered version.
  378.  
  379. * v1.13 - 09/16/1995
  380.  
  381.     There was a bug in Mod conversion (some patterns forgotten) which
  382.     caused samples data to be shifted.    You can now play
  383.     AUTOWASH, ARKHANGE, POSEIDON, DOUBLED2, CREAMOTE...
  384.  
  385.     If you load a new module manually (Eject button), it will be
  386.     automatically played (You don't need click on play)
  387.  
  388. * v1.14 - 09/24/1995
  389.  
  390.     You can modify the sound levels (e.g. with XControl), the MegaPlayer
  391.     won't restore them as it saved them to the end of a module.
  392.  
  393.     Spectrum Analyzer bands are now from 41 to 1311 Hz
  394.  
  395. * v1.15 - 07 & 08 of October 1995
  396.  
  397.     AV-Protocol is now supported :
  398.     - cycling of ALL windows (AV_SENDKEY)
  399.     - update of the desktop windows when saving a list (AV_PATH_UPDATE)
  400.     - Drag'n'Drop (VA_DRAGACCWIND) and VA_START for the registered version
  401.  
  402.     You can now double-click on a module of the List window to play it.
  403.  
  404. * - 10/15/1995
  405.  
  406.     S3M module sequence is now correctly converted.
  407.     Panoramics $c040 and $40c0 are only used above 12 voices.
  408.     OKT modules can be played with the demo version.
  409.  
  410.  
  411.  
  412. Known Bugs :
  413. ------------
  414.  
  415.     - Without NVDI, the Spectrum & Oscillos are over-displayed on the left
  416.     when they are on the right
  417.  
  418.     - If you select all the files of an directory with Selectric┐, the first
  419.     file will be replaced by the last one which is then selected twice.
  420.  
  421.     - Freedom seems not to work with List Window. It should be compatible with
  422.     Selectric┐ protocol but apparenlty it doesn't work.
  423.  
  424.  
  425. The Future, in order of priority :
  426. ----------------------------------
  427.  
  428.     New MGT format with multi-samples instruments with Tonality, Volume
  429.     and panning envelops and more pratical volumes.
  430.     => Real compatibility with XM modules and new GT2 format of the
  431.     Graoumf Tracker on Falcon.
  432.  
  433.     New faster replay routs.
  434.  
  435.     Setting of Speed and Tempo (BPM).
  436.     Intro and Shuffle Options for the modules list.
  437.     Releasing of the memory used by the module when you don't want to
  438.     hear it no more.
  439.  
  440.     Keyboard Shortcuts.
  441.     Compatibility with Freedom and use of its protocol.
  442.  
  443.     Number of repetitions for each module of the list (for Chip modules)
  444.  
  445.     Sound Control Panel for Filter, Trebles, Basses...
  446.     Parameters for the Spectrum Analyzer.
  447.  
  448.     Inter-application communication protocol for remoting by a program
  449.     which wants to use the MegaPlayer┐
  450.  
  451.     Loading of - Old Falcon DTM and GTK formats
  452.     - OktaMED-PRO (Amiga), DMF (PC) and Farandole (PC) formats.
  453.     - Old TCB Tracker (ST) and STM Scream-Tracker (PC) formats.
  454.  
  455.  
  456. The Author
  457. ----------
  458.  
  459.     This GEM Player has been entirely made by Simplet of FATAL DESIGN.
  460.     It has been completely programmed in pure 68030 & 56001 assembly code.
  461.     Nice Color Icon by Zack / FATAL DESIGN alias J.P. Maras.
  462.     Spanish Resource File and Docs by Antonio Lillo.
  463.  
  464.     This program is now Shareware, that is to say that you should send me
  465.     50FF, 15DM, £5 or $10 if you want to receive the registered version.
  466.  
  467.     I'd like to thank all that have already send me their contribution
  468.     (BLISS,Antonio Lillo and Arto/OH- in particular.)
  469.  
  470.     Don't hesitate to contact me for suggestions or critics
  471.     and don't forget to report bugs !!
  472.  
  473.     You can contact me at the following adress :
  474.     ( In French, English or German )
  475.  
  476.     Simplet / FATAL DESIGN    --->    LESAGE Stéphane
  477.                     Rue des Monts Jura
  478.                     01200 Châtillon-en-Michaille
  479.                     FRANCE
  480.  
  481.     If you can access the Internet or Compuserve e-mail, you can contact
  482.     me by sending me an electronic mail to the Compuserve address of
  483.     Skynet / FATAL DESIGN :    100620,2673@compuserve.com
  484.     Just precise it's for me.
  485.     You can get the last version of the Megaplayer on ftp.cnam.fr
  486.